SEGAJATURN 


SGL Reference 


Structure Reference 


This section introduces structures, variable types and macros that are unique 
to the SGL. These are essential to programming with the SGL, and the 
defined contents of each are also important. 


Study this reference in addition to the Function Reference. 


ATTR Face attribute list 


Refer to: Chapter 2, "Graphics" 


Structure 


typedef struct { 
Uint8 flag ; 
Uint8 sort ; 
Uint16 texno ; 
Uint16 atrb ; 
Uint16 colno ; 
Uint16 gstb 
Uint16 dir ; 
}ATIR; 


flag Front/back setting 

sort Sort setting 

texno Texture number 

atrb = Attribute data 

colno Color number 

gstb Gouraud setting 

dir Texture reversal setting and type 


This structure defines the polygon face attribute list. 


for details on the face attributes and how to use them, refer to chapter 7, 
"Polygon Face Attributes," in the Programmer's Tutorials. 


ATTR 


Structure 


typedef struct evnt { 
A = WORK *work ; 
== struct event *next ; 
struct event *before ; 
void (*exad)() ; 
Uint8 user[EVENT_SIZE-(sizeof(WORk*) 


a +sizeof(struct evnt*)*2+sizeof(void (*)()))] 
a }EVENT; 


work Work area pointer 

next Starting address of next event 
before Starting address of previous event 
_ (exad)() Function execution address 

user[] Work area 


gee 
This structure defines the event management table. Set the address received 
from the library function "slGetWork" in the member "work". 
oo | The default value is NULL. 


: "EVENT_SIZE" in the member "user[]" is 128 bytes. As a result, the user area is 
: 112 bytes. 


i 
set 
i 


ae 


its 


Refer to: Chapter 10, "Event Control" 


EVENT 


Structure 


typedef struct { 
POINT *pntb1 ; 
Uint32 nbPoint ; 
POLYGON “pltb1 ; 
ee Uint32 nbPolygon ; 
ATTR “attb1 ; 
} PDATA ; 


tt 


pntb1 Vertex list pointer 
nbPointNumber of vertices 

_ pltb1 Face list pointer 
nbPolygon Number of faces 
attb1 Attribute list pointer 


This structure defines the polygon model data. 


a 


Refer to: Chapter 2, "Graphics" PDATA 


Structure 


typedef struct { 

A Unit16 texno ; 
: Unit16 cmode ; 
: void *pesrc ; 

a } PICTURE ; 


texno Texture number 
cmode Color mode 
pcsrc Starting address of texture data to be registered 


This structure is the information table for transferring and registering texture data 
within VRAM. 


Refer to the textures in the "Polygon Face Attributes. 


Refer to: Chapter 7, "Polygon Face Attributes" PICTURE 


Structure 


____ typdef struct { 

: FIXED XST ; 
FIXED YST ; 
FIXED ZST ; 
FIXED DXST : 
: FIXED DYST ; 
: FIXED DX; 

: : FIXED DY ; 
oF a / FIXED MATA ; 

—] FIXED MATB ; 
FIXED MATC ; 
FIXED MATD ; 
FIXED MATE ; 
FIXED MATF ; 
| Sint16 PX ; 
Sint16 PY ; 
a Sint16 pZ ; 
Sint16 dummy0 ; 
= : Sint16 CX ; 

| Sint16 CY ; 
ae : Sint16 CZ ; 

Sint 16 dummy1 ; 
SS - FIXED MX ; 
FIXED MY ; 
FIXED KX; 
: : FIXED KY ; 
i : Uint32 KAST ; 

: oF Sint32 DKA ; 
JROTSCRLL ; 


set 
HE 


: XST — Scroll screen start coordinate Xst 

YST Scroll screen start coordinate Yst 

ZST Scroll screen start coordinate Zst 

' DXST_ Scroll screen vertical direction coordinate increment amount dXst 
DYST Scroll screen vertical direction coordinate increment amount dYst 
. DX Scroll screen horizontal direction coordinate increment amount dX 
Tf | DY Scroll screen horizontal direction coordinate increment amount dY 
_. MATA Rotating matrix parameter A 

a MATB_ Rotating matrix parameter B 

i : | MATC_ Rotating matrix parameter C 

MATD Rotating matrix parameter D 

= MATE Rotating matrix parameter E 

. MATF_ Rotating matrix parameter F 

oe : | PX Viewpoint coordinate Px 

= | PY Viewpoint coordinate Py 

/ PZ Viewpoint coordinate Pz 

dummy0O Dummy area 

CX Center coordinate Px 

CY Center coordinate Py 
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Refer to: 


Structure 


- CZ Center coordinate Pz 


dummy1 Dummy area 

MX Parallel movement amount Mx 

MY Parallel movement amount My 

KX Enlargement/reduction coefficient kx 

KY Enlargement/reduction coefficient ky 

KAST Coefficient table start address KAst 

DKAST Coefficient table vertical direction address increment DKAst 
DKA Coefficient table vertical direction address increment DKA 


_ This structure defines the rotation parameter table. 


The rotation parameter table is read for each line of the rotating scroll screen, and 
the screen is displayed according to those values. 


Used together with the NORMAL macro, this macro is used to make the 
POLYGON face list. 


ROTSCROLL 


Structure 


Refer to: 


typedef struct spratr { 
Uint16 texno ; 
Uint16 atrb ; 
Uint16 colno ; 
Uint16 gstb ; 
Uint16 dir ; 

} SPR_ATTR;; 


texno Texture number 

atrb = Attribute data (display mode) 
colno Color number 

gstb Gouraud shading table 

dir Texture reversal 


This structure is the parameter table for sprite display. Basically, these parameters 


conform with the texture parameters. 


Refer to the group of functions concerning sprite display. 


SPR_ATTR 


Structure 


typedef struct { 
Uint16 CTRL ; 
Uint16 LINK ; 
Uint16 PMOD ; 
. a Uint16 COLR ; 
Uint16 SRCA ; 
Uint16 SIZE ; 
Uint16 XA ; 
ne Uint16 YA ; 
| ag Uint16 XB ; 
Uint16 YB ; 
Uint16 XC ; 
: : Uint16 YC ; 
Uint16 XD ; 
Uint16 YD ; 
Uint16 GRDA ; 
| Uint16 DMMY ; 
| } SPRITE ; 


CTRL Control function 

Link address 

: : PMOD Put mode 

COLR Color data 

SRCA_ CG address 

SIZE Character size 

XA X coordinate of display position A 
YA Y coordinate of display position A 
XB X coordinate of display position B 
YB Y coordinate of display position B | 
XC X coordinate of display position C 

a he Y coordinate of display position C 

| XD X coordinate of display position D 

YD Y coordinate of display position D 

: GRDA Gouraud shading table 

DMMY Dummy data used to match up with size 


rt 
Zz 
A 


This data type is used to directly pass data to the VDP1, and is the data table 
used to display sprites. 


_ _ Sprite picture data must be stored and registered in VRAM beforehand. (The 
same is true for texture data and scroll data.) For details, refer to the textures in 
"Polygon 


| Face Attributes". 


a Textures and sprites used in the Sega Saturn system have very similar data 
structures, but their display methods differ as follows: 

Textures are applied to polygon faces and displayed. 

Sprites are displayed independently. 


Refer to: Chapter 7, "Polygon Face Attributes" SPRITE 


Structure 


Hite: 


Refer to: Chapter 7, "P 


typedef struct { 
Uint16 Hsize ; 
Uint16 Vsize ; 
Uint16 CGadr ; 
Uint16 HVsize ; 
} TEXTURE ; 


Hsize Horizontal size of texture 

Vsize Vertical size of texture 

CGadr CG address of texture/8 

HVsize Horizontal size/8, vertical size (for hardware) ((HSIZE/8)<<8)|(V SIZE) 


This structure is the texture management table that is needed in order to use 
textures in the SGL. 


For details, refer to chapter 7, "Polygon Face Attributes",in the Programmer's 
Tutorial. 


TEXTURE 
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Structure 


| typedef struct work { 
| So struct work *next ; 
: Uint8 user[WORK_SIZE-sizeof(struct work *)] ; 
: : } WORK ; 


next Pointer to next work area 
user[] Free area within the work area that the user can use 


seaEE 


This structure indicates a work area that can be used within an event. The 
= member "user" consists of the work size (WORK_SIZE = 64 bytes) less the size of 
_ the member "next" (4 bytes), for a total of 60 bytes. 


___ For details, refer to the Chapter 10, "Event Control" in the Programmer's Tutorial. 


Refer to: Chapter 10, "Event Control" WORK 


‘ 


Structure 


Sm e cDateTime RTC time 


8 typedef struct { 
: Uint16 year : 
: Uint8 month ; 
Uint8 date : 
Uint8 hour ; 
Uint8 minute ; 
Uint8 second ; 
[ - _ } SmpcDateTime ; 
see 
i year Year 
month Day of the week and month 
date Date 
a hour Hours 
| minute Minutes 
: : second Seconds 
This structure is used to reference the RTC time. 
= 
Use this structure when referencing the "rtc' member of the system variable 
"Smpc_ Status". 
i 
Refer to: HARDWARE MANUAL vol. 1 (SMPC) SmpcDateTime 


IZ 


Structure 


a cond Status 


rtc RTC time 


ctg Cartridge code 


area Area code 


' - system System status 


Refer to: HARDWARE MANUAL vol. 1 (SMPC) 


7 _ typedef — struct { 

L Uint8 cond ; 

: SmpcDateTime month ; 
oe Uint8 ctg : 

a a : Uint8 area ; 
a oo Uint16 system ; 

2 : Uint32 smem ; 

_ } SmpcStatus ; 


smem SMPC memory data 


__ This structure is used to reference the SMPC system status. 


= Use this structure when referencing the system variable "Smpc_ Status". 
a The member "rtc" can be referenced as the structure "SmpcDateTime". 


oe __ Special get and set functions are provided for the member "smem". 


SmpcStatus 
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Structure 


typedef _ struct { 
: Uint8 id ; 
: Uint8 ext : 
. | Uint16 data ; 
: Uint16 push ; 
Uint16 pull ; 
: } PerDigital ; 
i 
“ | id Peripheral ID 
: 7 ext Extended data size 
: data Current button data 
: push Depressed button data 
L pull Unpressed button data 


This structure is used to reference digital devices. 


Use this structure when referencing the system variable "Smpc_Peripheral". All 
devices can be handled as digital devices. 


He 


Refer to: HARDWARE MANUAL vol. 1 (SMPC) PerDigital 
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Structure 


typedef _ struct { 
Uint8 id ; 
Uint8 ext : 
ae Uint16 data ; 
: Uint16 push ; 
Uint16 pull ; 
ream Uint8 xe 
a Uint8 V 
: Uint8 rae 
_ } PerAnalog ; 
: | id Peripheral ID 
a ext Extended data size 
data Current button data 
_ push Depressed button data 
| pull Unpressed button data 
x Absolute value of X axis data 
y Absolute value of Y axis data 
| 2 Absolute value of Z axis data 
a _ This structure is used to reference analog devices. 


Ht 


Type-cast the system variable "Smpc Peripheral" and use this structure to 
reference a peripheral as an analog device. 


Refer to: HARDWARE MANUAL vol. 1 (SMPC) PerAnalog 
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Structure 


: : typedef _ struct { 
Uint8 id ; 
Uint8 ext : 
Uint16 data ; 
Uint16 push ; 
: : Uint16 pull ; 
aa a Uint16 x 
: / Uint16 ve 
} PerPoint ; 
fe = : 
id Peripheral ID 
ext Extended data size 
data Current button data 
push Depressed button data 
: pull Unpressed button data 
| | : X X coordinate 
L a | y Y coordinate 


| : _ This structure is used to reference a pointing device. 
eeeaees 
7 Type-cast the system variable "Smpc_Peripheral" and use this structure to 
: ar / reference a peripheral as a pointing device. 
Refer to: HARDWARE MANUAL vol. 1 (SMPC) PerPoint 
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Structure 


typedef _ struct { 
i | Uint8 id ; 
: Uint8 ext : 
ae Uint16 data ; 
a Uint16 push ; 
i Uint16 pull ; 
: : Uint8 cond ; 
! Uint8 code ; 
= : } PerKeyBoard ; 
id Peripheral ID 
ext Extended data size 
L data Current button data 
push Depressed button data 
| a pull Unpressed button data 
_ cond Status data 
_ code Key code 
ie Hy i 
_ This structure is used to reference the keyboard device. 
Hens : | 
: : _ Type-cast the system variable "Smpc_Peripheral" and use this structure to 
- reference a peripheral as a keyboard device. 
Refer to: HARDWARE MANUAL vol. 1 (SMPC) PerKeyBoard 
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Variable Type 


a typedef Sint16 ANGLE ; 


aE : Angle data notation variable type. 
: The range from 0j to 359; is expressed by 0x0000 to Oxffff. 


Refer to: : Chapter 1, "Sega Graphics Library" ANGLE 
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Variable Type 


typedef Sint32 FIXED ; 


This variable type indicates fixed-point decimal data. FIXED-type values are 
: represented in the following manner. 

_ High-order 16 bits: Integer portion 

Low-order 16 bits: Decimal portion 

. Ex,: 16.5 -> 0x00108000 


seer t fae 


Refer to: Chapter 1 "Sega Graphics Library" 


FIXED 
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Variable Type 


typedef FIXED MATRIX(4][3] ; 


a _ Matrix notation variable type 
: _ FIXED matrix [4][3]; 
ae : MATRIX matrix; 
| . _ The two definitions shown above have the same meaning. 
: = 
L 
Refer to: Chapter 5, "Matrices" MATRIX 
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se 


Refer to: Chapter 2, "Graphics" 


POINT Vertex data type 


Variable Type 


typedef FIXED POINT[xyz] ; 


This variable type defines the vertex data used in polygons. 


FIXED point [xyz]; 

FIXED point [3]; 

POINT point; 

All three of the above definitions have the same meaning. 


POINT 
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Variable Type 


typedef UINT16 TEXDAT ; 


This variable type is used to define the actual texture itself. 


panies 


Refer to: Chapter 7, "Polygon Face Attributes" TEXDAT 
Ze 


Variable Type 


TYPED FIXED VECTOR[XYZ} 


eee 


Vector data variable type 


FIXED vector[XYZ]; 
= FIXED vector[3]; 
: _ VECTOR vector 
A The above three definitions all have the same meaning. 


Refer to: VECTOR 
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MACRO 


He 


ae 


th 


ft 
i 


#define ATTRIBUTE(plane, sort, texture, color,gourand,mode,dir,option) 
@@@@ { 
plane, (sort)|(((dir)>>16)&0x01c)|(option), — 
texture,(mode)|(((dir)>>24)&0xc0,color _ 
gourud, (dir) &0x03f 


Uint8 plane ; 
Uint8 sort ; 
Uint16 texture ; 
Uint16 color ; 
Uint16 gouraud ; 
Uint 16 mode ; 
Uint 32 dir ; 
Uint16 option : 


plane Front/back attribute 

sort Z sort specification 

texture Texture number, or No_Texture 

color C_RGB macro-specified color, color palette number, or No Palet 
gouraud Gouraud table, or No_Gouraud 

mode Various mode specifications for the polygon 

dir Specification of texture display direction, etc. 


_ option Other settings for the polygon 


This macro sets the face attributes (particularly the polygon front face) 
concerning polygon drawing. For details on the meaning of and substitution 
values for each parameter, refer to chapter 7, "Polygon Face Attributes," in the 


_ Programmer's Tutorial. Also refer to the list of ATTRIBUTE macro substitution 


values at the end of the Structure Reference. 


When using texture, the member color is sometimes used to specify the color 
bank number. 


Refer to: Chapter 7, "Polygon Face Attributes" ATTRIBUTE 


MACRO 


C RGB RGB value specification 


#define C_RGB(r,g,b) (((b)&0x1f)<<10|(g)&0x1f)<<5|((r)&0x1f) |0x8000) 
Uint8r ; 

. Uint8 g ; 

Uint8 b ; 


L This macro specifies the RGB values used to represent color gradations. The 
__ color gradation values can range from 0 to 1f for each of red, green, and blue. 


/ This macro cannot be used to specify the transparent color. 


Refer to: Chapter 7, "Polygon Face Attributes" C_RGB 


2 


MACRO 


#define DEGtoANG(d) (ANGLE)((d)*65536.0/360.0)) 
float d ; 


d Angle to be converted (DEG notation) 


This macro converts a floating-point angle value expressed in DEG notation to 


_ an ANGLE-type value. 


Refer to: Chapter 1, "Sega Graphics Library" DEGtoANG 
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ORMAL Coordinate value conversion macro 


MACRO 


oa 


#define NORMAL(x,y,z) (POStoFIXED(x,y,z) 


x X coordinate to be converted 
y Y coordinate to be converted 
Z Z coordinate to be converted 


This macro converts a normal vector XYZ coordinates expressed by floating- 


point decimals into FIXED-type variables. 


Used together with the VERTICES macro, this macro is used to make the 
POLYGON face list. 


aes 


Refer to: 


NORMAL 


MACRO 


P ICDEF Texture management table 


. #define PICDEF(texno,cmode,pcsrc) {(Uint16)(texno),(Uint16)(cmde), 
(void*)(pcsrc)} 
i Uint16 texno ; 
Uint16 cmode ; 
ae Hs He ‘ 
: void*pesrc ; 


texno Texture number 
cmode Color mode (COL_16, 64, 128, 256, or 32K) 
pcsrc Pointer for texture data defined by "TEXDAT" 


. This macro creates the table of information used to set a texture in VRAM so that 
ee the texture can be handled within a program. 


Refer to: Chapter 7, "Polygon Face Attributes" PICDEF 


i 
HH 


ff 


Soe 


#define POStoFIXED(x,y,z) {toF XED(x),(toF IXED(y),toFIXED(z)} 


| x X coordinate to be converted 
y Y coordinate to be converted 
Z Z coordinate to be converted 


This macro converts the XYZ coordinate values to FIXED-type variables. 


Refer to: Chapter 1, "Sega Graphics Library" POStoFIXED 
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#define TEXDEF(h, v,presize) (h,v,(((cgaddress+(presize))*4)>>pal)/8, 
(((h)&0x1f8)<<5|(v))} 
A : Uint16h ; 
Uint16v ; 
/ Uint32 presize ; 
: h Horizontal size of texture 
Vv Vertical size of texture 
presize Previously registered texture size (vertical x horizontal) 


: This macro creates a table for getting texture information. 


i 


Reference macros 
#define cgaddress 0x10000 
#define pal COL_32K 


Refer to: Chapter 7, "Polygon Face Attributes" TEXDEF 


MACRO 


#define toF IXED(a) ((FIXED)((a)*65536.0) 


a Value to be converted 


This macro converts the value supplied as the parameter into a FIXED-type 


value. 


= 


Refer to: Chapter 1, "Sega Graphics Library" toFIXED 
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: _ #define VERTICES(vO0, v1, v2, v3) (vO, v1, v2, v3}} 
: Uint16 vo ; 
= Uint16 v1 ; 
Uint16 v2 ; 
Uint16 v3 ; 
= v0 Vertex vO 
7 vi Vertex v1 
v2 Vertex v2 
v3 Vertex v3 
ae Hit L 
This macro specifies the polygon vertex numbers expressed as integers. 
: Used together with the NORMAL macro, this macro is used to make the polygon 
ce _ face list. 
. a 
Refer to: Chapter 2, "Graphics" VERTICES 
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